加油基础推送 | 商户->百度
更新时间:2024-03-04
1. 油站、油价数据推送(必须)
1.1推送频率
1)实时变更数据推送,包括油站状态、油价等
2)每天一次全量数据推送(含油站状态、油价)
1.2推送地址
线上地址:平台分配
推送方式:HTTP POST,将推送字段打包成JSON格式,写入到HTTP地址。
推送成功返回:
{
"errno": 0,
"errstr": "",
"desc": "",
"data": {
}
}
1.3字段
basic对象(油站基础信息):
字段标签 | 字段名称 | 字段说明 | 字段要求 | 字段长度 | 是否必须 | |
---|---|---|---|---|---|---|
1 | id | 油站id | 油站唯一标识 | string | 64 | 是 |
2 | poi_name | 油站名称 | 准确的油站名称,例如:壳牌加油站、xx加油站等 | string | 256 | 是 |
3 | city | 所在地城市 | 北京、上海(传入城市名称) | string | 64 | 是 |
poi_address | 油站地址 | 详细的地址,例如:辽宁省,沈阳市,皇姑区,黄河北大街xxx号 | string | 256 | 是 | |
latitude | 油站所在地纬度 | 百度坐标(BD09MC) | double | 64 | 是 | |
longitude | 油站所在地经度 | 百度坐标(BD09MC) | double | 64 | 是 | |
tel | 门店联系方式 | 联系电话或手机号码等 | string | 64 | 是 | |
status | 营业状态 | 参考附录:油站基础数据状态(status)取值说明 | int | - | 是 | |
county | POI所在行政区 | 东城区(传入行政区名称) | string | 64 | 否 | |
aoi | POI所在商圈 | 天安门;王府井地区(可选,多个;分开) | string | 256 | 否 | |
brand | POI品牌 | 品牌 | string | 64 | 否 | |
shop_business | 营业时间 | "00:00:00-24:00:00" | string | - | 是 | |
images | 油站图片 | 对象如下 | Array | - | 是 | |
location_type | 坐标类型 | 坐标类型 1-百度,2-腾讯,3-火星 | int | 64 | 是 |
basic.image对象
字段标签 | 字段名称 | 字段说明 | 类型 | 是否必须 |
---|---|---|---|---|
1 | image_url | 图片链接 | string | 是 |
2 | image_title | 图片名称 | string | 是 |
3 | image_type | 图片类型(exterior外景 、inner内景、firstphoto头图、other其它) | string | 是 |
detail对象
字段标签 | 字段名称 | 字段说明 | 字段要求 | 类型 | 字段长度 | 是否必须 |
---|---|---|---|---|---|---|
1 | gas_type | 油站类型 | gas_brand_name 油站品牌 | string | 64 | 否 |
2 | is_invoice | 开票信息 | 是否能开发票 0 不能开 1 能开 2 不确定能不能开 | int | 4 | 否 |
3 | is_free | 当前排队情况 | 油站当前是否空闲 0排队 1空闲 | int | 4 | 否 |
4 | label_map | 标签集合 | 对象如下 | object | 否 |
label_map 对象
参数 | 类型 | 含义 | |
---|---|---|---|
1 | service_taglist | Array | 服务类标签列表,具体参考下面 tag 对象 |
2 | activity_taglist | Array | 活动类标签列表,具体参考下面 tag 对象 |
3 | custom_taglist | Array | 自定义类标签列表,具体参考下面 tag 对象 |
4 | system_taglist | Array | 系统促销类标签列表,具体参考下面 tag 对象 |
tag 对象
参数 | 类型 | 含义 | |
---|---|---|---|
1 | tag_name | String | 标签名称 |
2 | tag_image_name | String | 标签图片 URL |
3 | tag_index_description | String | 首页标签描述 |
4 | tag_description | String | 标签描述 |
5 | tag_type | String | 标签类型,0:自定义类,1:活动促销类,2:系统促 销类,3:服务类 |
price_official_list数组(国标价数据)
字段标签 | 字段名称 | 字段说明 | 字段要求 | 字段长度 | 是否必须 | |
---|---|---|---|---|---|---|
1 | oil_name | 油号 | 92#、98#、0# | string | 64 | 是 |
2 | price_official | 国标价 | 单位元 | double | - | 是 |
3 | vs | 国标价格相比昨天的变化 | 0无变化、1今天高、3今天低 | int | - | 否 |
price_discount_list对象(服务方优惠信息)
字段标签 | 字段名称 | 字段说明 | 字段要求 | 字段长度 | 是否必须 | |
---|---|---|---|---|---|---|
1 | tp_name | 渠道号 | 开发前分配渠道号和私钥(primary_key),请妥善保管 | string | 64 | 是 |
2 | gas_id | 油站id | 油站唯一标识 | string | 64 | 是 |
3 | price_list | 价格数组 | 服务方优惠价格信息 | array | - | 是 |
4 | oil_name | 油号 | 92#、98#、0# | string | 64 | 是 |
5 | org_price | 油站挂牌价 | double | - | 是 | |
6 | price | 通用优惠价 | double | - | 是 | |
7 | vip_price | 新客价、VIP客户价 | double | - | 否 | |
8 | src平台分配 | 等同于tp_name值 | string | 64 | 是 | |
9 | gas_id | 油站id | 油站唯一标识 | string | 64 | 是 |
10 | sku_id | 油号标识 | 1、如果下单页是百度小程序,此字段用于跳转到小程序指定油枪号,由三方提供【这种模式在逐步废弃】 2、下单页 h5,默认传油号:92\85\98\0 | string | 64 | 是 |
11 | gunNos | 油枪号list | ["1","3"] | Array | - | 是 |
12 | original_gas_id | 服务商油站id | 适用于综和油站来源 | sring | - | 否 |
13 | original_gas_name | 服务商英文标识 | 适用于综和油站来源 | string | - | 否 |
{
"basic": {
"status": "1",
"city": "成都市",
"tel": "4008396555",
"longitude": 104.182521,
"poi_address": "青白江区货运大道白马村2组(省市区县精确到门牌号越详细越好)",
"latitude": 30.872307,
"id": "92699595369",
"poi_name": "中国石化白马北加油站",
"county":"",
"aoi":"",
"brand":"中国石化",
"shop_business":"00:00:00-24:00:00",
"images":[
{
"image_url":"xxxx",
"image_title":"头图",
"image_type":"firstphoto"
},
{
"image_url":"xxxx",
"image_title":"外景",
"image_type":"exterior"
}
]
},
"detail": {
"gas_type": "中国石化", //油站品牌
"is_invoice": 2, //是否可开发票
"is_free":1, //是否空闲
"label_map": {
"service_taglist": [
{
"tag_name": "xx",
"tag_image_name": "xxx",
"tag_index_description": "xxx",
"tag_description": "xxx",
"tag_type": 1
}
],
"activity_taglist": [
{
"tag_name": "周二优惠", //标签名称
"tag_image_name": "xxx", //标签图片 URL
"tag_index_description": "周二优惠", //首页标签描述
"tag_description": "周二加汽油可享优惠直降0.8元/L", //标签描述
"tag_type": 1 //标签类型
}
],
"custom_taglist": [
{
"tag_name": "xx",
"tag_image_name": "xxx",
"tag_index_description": "xxx",
"tag_description": "xxx",
"tag_type": 1
}
],
"system_taglist": [
{
"tag_name": "xx",
"tag_image_name": "xxx",
"tag_index_description": "xxx",
"tag_description": "xxx",
"tag_type": 1
}
]
}
},
"price_official_list": [ //国标价数据
{
"oil_name": "92#", //油号
"price_official": "6.9", //国标价,单位元
"vs": "1" //相比昨天的变化, #0 平 1 今高 3 今低
},
{
"oil_name": "95#",
"price_official": "7.37",
"vs": "1"
},
{
"oil_name": "0#",
"price_official": "6.52",
"vs": "1"
}
],
"price_discount_list": {
"tp_name": "平台分配", //例如 yijiayou
"gas_id": "5389825986895835545",//油站标识
"price_list": [
{
"oil_name": "92#", //油号
"org_price": 6.76, //油站挂牌价
"price": 5.99, //通用优惠价
"vip_price": 5.52, //新客价、VIP客户价
"src": "平台分配", //例如 yijiayou = tp_name
"gas_id": "5389825986895835545", //油站标识
"sku_id": "4879454965524071453",//油号标识,百度跳转至三方会在参数中拼接该字段,用于跳转到小程序指定油枪号
"gunNos" : [ //油枪号
"1",
"3",
"8",
"10",
"12",
"13",
"14"
]
},
{
"oil_name": "95#",
"org_price": 7.22,
"price": 6.37,
"vip_price": 5.87,
"src": "平台分配",
"gas_id": "5389825986895835545",
"sku_id": "4879454965540848671",
"gunNos" : [ //油枪号
"5",
"7",
"9",
"11"
],
}
]
}
}
2. 用户权益推送(可选)
1.1推送频率
1)实时变更数据推送,包括油站状态、油价等
2)天级全量数据推送(含油站状态、油价)
1.2推送地址
测试地址:https://maphotel.baidu.com/map_mc/mc/userright?partner_name=test_tp
线上地址:平台分配
推送方式:HTTP POST,将推送字段打包成JSON格式,写入到HTTP地址。
推送成功返回:
{
"errno": 0,
"errstr": "",
"desc": "",
"data": {
}
}
1.3字段
{
"mobile": "手机号",
"bdmap_user_id": "由平台跳转到三方时携带",
"is_new_user": "1" //其他权益字段
}
附1:基础信息status字段说明:通常情况,1为合作站点,2为不合作站点,当status置为2,地图会下线该点位的相关服务。
合作方填写 | 映射状态 |
---|---|
营业中 | 1 |
正常营业 | 1 |
删除 | 2 |
暂停营业 | 3 |
筹建中 | 5 |
已停业 | 9 |
已关闭 | 9 |